home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / wp / tsetd25.zip / POTPOURR.DAT < prev    next >
Text File  |  1996-01-31  |  41KB  |  995 lines

  1.     ;
  2.     ;
  3.     ; SemWare Potpourri Macro data file.
  4.     ;
  5.     ; *WARNING*     DO NOT EDIT THIS FILE DIRECTLY!!!
  6.     ;
  7.     ; The Potpourri macro expects this file to be in a certain format.
  8.     ;
  9.     ;
  10. ASCII       Alternate ASCII chart
  11.  
  12.             Overview:
  13.  
  14.             This ASCII chart provides additional information for characters 0
  15.             thru 31.
  16.  
  17.             Keys:       (none)
  18.  
  19.             Usage notes:
  20.  
  21.             This macro does not have any key assignments.  To use, simply select
  22.             it from the Potpourri menu.
  23.  
  24. Adjust      Adjusts text in a marked block to the right, left or center
  25.  
  26.             Overview:
  27.  
  28.             This macro allows you to adjust text within a block by aligning it
  29.             either on the left or right, or by centering it.  If a column block
  30.             is marked, the macro operates on the text in the block using the
  31.             leftmost and/or rightmost column boundary (as appropriate).  If a
  32.             line or character block is marked, it operates on the text on the
  33.             lines spanned by the block, using the left and/or right margin (as
  34.             appropriate).  A selection menu issued by the macro allows you to
  35.             choose whether you want to left adjust, right adjust, or center the
  36.             text.
  37.  
  38.             Keys:       (none)
  39.  
  40.             Usage notes:
  41.  
  42.             This macro does not have any key assignments.  To use, simply select
  43.             it from the Potpourri menu.
  44.  
  45. Align       Aligns current line with previous line, or at cursor position
  46.  
  47.             Overview:
  48.  
  49.             Align() positions the FirstNonWhite character on the current line to
  50.             the same position of the FirstNonWhite character on the previous
  51.             line or the first preceding non-blank line.  The cursor will then be
  52.             moved to the next line in the file.
  53.  
  54.             AlignAtCursor() positions the FirstNonWhite character on the current
  55.             line to the cursor position.  The cursor will then be moved to the
  56.             next line in the file.
  57.  
  58.             Keys:
  59.                       <Ctrl F5>       Align()
  60.                       <Ctrl F6>       AlignAtCursor()
  61.  
  62.             Usage notes:
  63.  
  64.             If the current line is blank, the cursor will still go to the next
  65.             line of the file, but no alignment will occur.
  66.  
  67. Book        Bookmark manager - allows visual display of active bookmarks
  68.  
  69.             Overview:
  70.  
  71.             These macros will give a visual display of all active bookmarks.
  72.             This comes in very handy when you cannot remember which bookmark
  73.             takes you to the desired location.  When you pop up the PickList, a
  74.             portion of the line where bookmarks are located will be displayed so
  75.             you can choose based on the content of the line.
  76.  
  77.             Keys:
  78.                       <Ctrl />        PlaceBookMark
  79.                       <Ctrl .>        GotoNextBookMark
  80.                       <Ctrl ,>        GotoPreviousBookMark
  81.                       <CtrlShift />   ViewBookMarkList
  82.  
  83.             Usage notes:
  84.  
  85.             Using the <Ctrl /> key, you can place bookmarks at any place in any
  86.             file.  The bookmarks are numbered in sequential order beginning with
  87.             1.  Pressing the <Ctrl .> and <Ctrl ,> keys will go to the next and
  88.             previous bookmarks respectively.  Pressing the <CtrlShift /> key
  89.             will invoke the PickList which shows the bookmark number, file, line
  90.             number, and part of the text on the line where each bookmark is
  91.             located.
  92.  
  93. CD          A "chdir" command for TSE
  94.  
  95.             Overview:
  96.  
  97.             Provides a facility to change the current directory within TSE.
  98.             Either full or partial pathnames may be entered.  Limited to drives
  99.             identified by alphabetic letters followed by a colon (e.g., "c:").
  100.  
  101.             Detailed help is available by invoking the macro and following the
  102.             prompts.
  103.  
  104. Calendar    Displays a visual, changeable calendar
  105.  
  106.             Overview:
  107.  
  108.             Three calendar displays are available -- Medium-Size Single Month,
  109.             Three Months at a Time, and a Small Single Month. (Press <Alt C> to
  110.             toggle between them.)
  111.  
  112.             A small calendar can be inserted into the current file by pressing
  113.             <Alt I>. Here is a sample:
  114.  
  115.                  ┌────────────────────┐
  116.                  │April      5th  1993│
  117.                  │Su Mo Tu We Th Fr Sa│
  118.                  │             1  2  3│
  119.                  │ 4[ 5] 6  7  8  9 10│
  120.                  │11 12 13 14 15 16 17│
  121.                  │18 19 20 21 22 23 24│
  122.                  │25 26 27 28 29 30   │
  123.                  └────────────────────┘
  124.  
  125.             Keys:
  126.                 Next Day                  <CursorUp> or <CursorRight>
  127.                 Previous Day              <CursorDown> or <CursorLeft>
  128.                  
  129.                 Next Month                <+>, <SpaceBar> or <Enter>
  130.                 Previous Month            <-> or <BackSpace>
  131.                  
  132.                 Next Year                 <PgUp>
  133.                 Previous Year             <PgDn>
  134.                  
  135.                 First Day Of Month        <Home>
  136.                 Last Day Of Month         <End>
  137.                  
  138.                 First Day Of Year         <Ctrl Home>
  139.                 Last Day Of Year          <Ctrl End>
  140.                  
  141.                 Today                     <Alt T>
  142.                 Change Calendar Type      <Alt C>
  143.                 Insert Calendar into Text <Alt I>
  144.                 Exit Calendar             <Escape>
  145.  
  146. ClipView    Simple ClipBoard Viewer utility for PROJECTS
  147.  
  148.             Overview:
  149.  
  150.             This file provides a simple ClipBoard viewer.  It allows ClipBoards
  151.             "A" through "Z" to be viewed.  It was written as a support file for
  152.             PROJECTS.
  153.  
  154.             Keys:       (none)
  155.  
  156.             Usage notes:
  157.  
  158.             This macro may be executed from the PROJECTS macro, or may be
  159.             executed directly from Potpourri or the "Execute Macro:" prompt.
  160.  
  161. Clock       StatusLine clock for TSE
  162.  
  163.             Overview:
  164.  
  165.             This clock uses binary support to help determine whether or not data
  166.             is overlaying the spot where the time would go.  It also retrieves
  167.             its color attribute byte from the first byte on the screen, so it
  168.             always knows what color to set the clock to.
  169.  
  170.             In addition, if "Eliminate Snow" is set within TSE, snow checking
  171.             will also be performed, if the card is determined to be a CGA card.
  172.  
  173.             Keys:       (none)
  174.  
  175.             Usage notes:
  176.  
  177.             Simply load or execute this macro to display a simple clock on the
  178.             StatusLine.
  179.  
  180. CmpFiles    Compares the current file to a backup file
  181.  
  182.             Overview:
  183.  
  184.             The user will be prompted for a backup filename.  This backup file
  185.             may be inside an "ARC", "ARJ", "LZH", or "ZIP" file, or it may be a
  186.             stand alone file.  If the file is inside an archive, then the
  187.             filename must be the same as the current filename.  Note that there
  188.             may be many different files inside the archive, but only the one
  189.             that matches the current filename will be extracted.
  190.  
  191.             The two files will be split (either vertically or horizontally).
  192.             Cursor movement keystrokes will be fed to both windows so that they
  193.             move simultaneously, in sync with each other.
  194.  
  195.             Text may be scanned, and differences will be highlighted.
  196.  
  197.             The video mode may be changed from 25 to 36 to 44 to 50 lines to
  198.             show more detail.
  199.  
  200.             F1 is available for help.
  201.  
  202.             Whitespace characters (spaces and tabs) are automatically converted
  203.             to a single space character by default, in an effort to reduce false
  204.             comparisons.  This option may be toggled by pressing the "W" key.
  205.  
  206.             Once a re-sync has been accomplished, both windows will update to
  207.             the end of the difference text, with the re-synced lines adjacent to
  208.             each other on line 12 of the screen.  Difference text will be marked
  209.             in both windows, for easy comparison.  Press the grey- key to
  210.             retreat to the BEGINNING of the difference text, then press the
  211.             grey+ key to move back to the END of the difference text.  Hit the
  212.             enter again to continue the search process, -- to find and highlight
  213.             the next difference.
  214.  
  215.             Keys:       (none)
  216.  
  217.             Usage notes:
  218.  
  219.             This macro is designed to be run from PROJECTS or may be executed
  220.             directly from Potpourri.  It is automatically purged when done.
  221.  
  222.             LIMITATIONS: -Line length must be under 256 characters.
  223.  
  224.                          -although whitespace errors will NOT cause files that
  225.                           are already in sync to de-sync (unless the whitespace
  226.                           filter is turned off), TSE's basic search mechanism is
  227.                           used to re-sync, and whitespace cannot be filtered out
  228.                           here.  This is usually not too big of an issue unless
  229.                           you completely en-tab, or de-tab one of the two files.
  230.                           Then re-syncing will NOT take place.
  231.  
  232.                          -Your file decompressor must be in the path, or a "File
  233.                           Not Found"  error message will result.
  234.  
  235.             The usual disclaimer -- Use these macros at your own risk! I will in
  236.             NO WAY be responsible for ANY problems resulting in their use.
  237.  
  238. CUAMark     Enables <Shift>+cursor-keys to emulate CUA-style block marking
  239.  
  240.             Overview:
  241.  
  242.             This macro modifies the <Shift>+cursor-keys to emulate CUA-style
  243.             block marking and manipulating.  It also assigns other keys to
  244.             comply with CUA standards, including key assignments for Paste (from
  245.             the System ClipBoard), CopyBlock (from the System ClipBoard), Cut
  246.             (to the System ClipBoard), and DelBlock.
  247.  
  248.             Keys:
  249.                   <Shift Ins>             Paste-to-clipboard
  250.                   <Ctrl Ins>              Copy-from-clipboard
  251.                   <Shift Del>             Cut-to-clipboard
  252.                   <Ctrl Del>              DelBlock
  253.  
  254.                   <Shift CursorRight>     Mark while going right
  255.                   <Shift CursorLeft>      Mark while going left
  256.                   <Shift CursorUp>        Mark while going up
  257.                   <Shift CursorDown>      Mark while going down
  258.                   <Shift Home>            Mark while going to begline
  259.                   <Shift End>             Mark while going to endline
  260.                   <Shift PgUp>            Mark while going page up
  261.                   <Shift PgDn>            Mark while going page down
  262.                   <CtrlShift CursorRight> Mark while going word right
  263.                   <CtrlShift CursorLeft>  Mark while going word left
  264.                   <CtrlShift Home>        Mark while going begwindow
  265.                   <CtrlShift End>         Mark while going endwindow
  266.                   <CtrlShift PgUp>        Mark while going begfile
  267.                   <CtrlShift PgDn>        Mark while going endfile
  268.  
  269.             Usage notes:
  270.  
  271.             If you wish to make this macro a permanent part of your
  272.             configuration, then simply add "CUAMark" to the AutoLoad list on
  273.             the Macro menu.
  274.  
  275. Date        Inserts current date (format includes Month spelled out)
  276.  
  277.             Overview:
  278.  
  279.             This macro inserts the current date with the full name of the month
  280.             and a 4-digit year.  The format is as follows:
  281.  
  282.                               January 27, 1994.
  283.  
  284.             Keys:       (none)
  285.  
  286.             Usage notes:
  287.  
  288.             This macro does not have any key assignments.  To use, simply select
  289.             it from the Potpourri menu.
  290.  
  291. DelToBol    Delete text from cursor to beginning of current line
  292.  
  293.             Overview:
  294.  
  295.             This macro is the complement to the DelToEol() command.  All text
  296.             from the beginning of the line through the position preceding the
  297.             cursor will be deleted.
  298.  
  299.             Keys:       (none)
  300.  
  301.             Usage notes:
  302.  
  303.             This macro does not have any key assignments.  To use, simply select
  304.             it from the Potpourri menu.
  305.  
  306.  
  307. EditFile    Enhanced EditFile command
  308.             Overview:
  309.  
  310.             This macro enhances EditFile() by trying to load the file from the
  311.             current directory first, and if unsuccessful, it then tries the
  312.             current file's directory.  If wildcards are used, two picklists will
  313.             be presented -- one for the current directory and one for the
  314.             current file's directory.
  315.  
  316.             Simply load this macro and press <Alt E> to pull up the
  317.             SmartEditFile() prompt.
  318.  
  319.             Keys:
  320.                   <Alt E>  SmartEditfile()
  321.  
  322.             Usage notes:
  323.  
  324.             With this macro, you can literally tag and load thousands of
  325.             filenames in mere seconds (for example, it took just 12 seconds to
  326.             mark and load all 433 filenames in one of my larger directories).
  327.  
  328.             Major features include:
  329.  
  330.               1.  File tagging for multiple file loading and deletions.
  331.  
  332.                   While in an Edit PickFile, multiple files may be tagged by
  333.                   first highlighting a file and then by pressing the SPACEBAR. A
  334.                   tag will appear in the "tag" position of the PickFile in the
  335.                   column along the left.
  336.  
  337.                   Tagging key alternatives to the SPACEBAR include the GREY PLUS
  338.                   key, the GREY MINUS key, the INSERT key, and the LEFT mouse
  339.                   button.
  340.  
  341.                   Press ENTER or click the RIGHT mouse button on a filename, to
  342.                   load all of the tagged files, or just the selected file if no
  343.                   tags are present.  Both normal files, as well as binary and
  344.                   hex files, may be tagged and loaded in this manner.
  345.  
  346.                   Press DELETE to delete all tagged files, or just the selected
  347.                   file if no files are tagged.
  348.  
  349.                   In addition, subdirectories may also be deleted, provided that
  350.                   they are empty.  Subdirectories may NOT be tagged.
  351.  
  352.               2.  PickFile Sorting
  353.  
  354.                   If a wildcard is utilized, or if a directory is referenced,
  355.                   then TSE will provide a PickFile showing multiple file
  356.                   choices.  This PickFile may now be sorted.  Files may be
  357.                   sorted by name, extension, date, or size.
  358.  
  359.               3.  Dual Directory Searching
  360.  
  361.                   If a file is not found in the current directory, and if the
  362.                   current file at the top of TSE's ring of files is in a
  363.                   directory different from the current directory, then an
  364.                   attempt will be made to locate the file(s) in this directory.
  365.                   This action will apply to both single files as will as
  366.                   wildcard PickFiles and with multiple filenames.
  367.  
  368. Expand      Expands the current partial word based on match in current file
  369.  
  370.             Overview:
  371.  
  372.             This macro file provides a macro that operates like a limited,
  373.             dynamic Template mode.  It expands, or completes, the "partial" word
  374.             to the left of the cursor based on other words in the file. When you
  375.             execute Expand from the Potpourri PickList, the Expand macro is
  376.             assigned to <Ctrl H>.
  377.  
  378.             Keys:
  379.                         <Ctrl H>  Expand()
  380.  
  381.             Usage notes:
  382.  
  383.             With this macro activated, just press <Ctrl H> each time you want to
  384.             complete the partial word immediately preceding the cursor. The
  385.             macro searches backward and forward in the file for words that begin
  386.             with the string that you typed as the partial word. If only one
  387.             match is found, the partial word is replaced with the expanded word.
  388.             If multiple matches are found, the macro first displays a PickList
  389.             of expanded entries from which you can choose.  To select an
  390.             expanded word from the PickList, move the cursor bar over the
  391.             desired entry and press <Enter>.  Your partial word is then replaced
  392.             in the text with the expanded word you selected.
  393.  
  394. Expr        Calculates the value of a specified mathematical expression
  395.  
  396.             Overview:
  397.  
  398.             This macro operates as a simple calculator, and handles decimal or
  399.             hexadecimal numbers.  For decimal numbers, only whole numbers are
  400.             accepted.
  401.  
  402.             Keys:       (none)
  403.  
  404.             Usage notes:
  405.  
  406.             This macro does not have any key assignments.  To use, simply select
  407.             it from the Potpourri menu.
  408.  
  409.             The following operations are available:
  410.  
  411.                       >      SHR      (bitwise shift right)
  412.                       <      SHL      (bitwise shift left)
  413.                       ~      COMP     (2's complement)
  414.                       %      MOD      (modulo division)
  415.                       &      AND      (bitwise AND)
  416.                       |      OR       (bitwise OR)
  417.                       ^      XOR      (bitwise eXclusive-OR)
  418.                       +      Addition
  419.                       -      Subtraction
  420.                       *      Multiplication
  421.                       /      Division
  422.  
  423.             Precedence is as in SAL, but can be forced by using parenthesis.
  424.  
  425.             Hex number may be entered using C format, or ending with an 'h' or
  426.             '$'.  Regardless, the first character _must_ be numeric.
  427.  
  428. FillNum     Fill a COLUMN block with a sequence of numbers
  429.  
  430.             Overview:
  431.  
  432.             This macro fills a column block with a series of numbers that can be
  433.             incremented or decremented.  You specify the beginning and
  434.             (optionally) ending number in the series, as well as the positive or
  435.             negative amount by which to increment or decrement the series.
  436.  
  437.             Keys:       (none)
  438.  
  439.             Usage notes:
  440.  
  441.             This macro does not have any key assignments.  To use, simply select
  442.             it from the Potpourri menu.
  443.  
  444. FindEOL     Macros to find and replace text that include the end of line
  445.  
  446.             Overview:
  447.  
  448.             This macro file provides a group of macros that allow you to find
  449.             and replace text that includes the end of line, if you specify the
  450.             end of line (as "$") in the search string.  These macros are useful
  451.             for locating a text string that begins on one line, and ends on
  452.             another.  They are also useful for such tasks as:
  453.  
  454.               ∙ Deleting extra blank lines in a file
  455.  
  456.                 For example, to change all occurrences of 2 blank lines to a
  457.                 single blank line, use this macro to search for "$$$" and
  458.                 replace with "$$".
  459.  
  460.               ∙ Removing trailing text from certain lines
  461.  
  462.                 For example, to remove a trailing comma from any lines
  463.                 immediately followed by a blank line, use this macro to search
  464.                 for ",$$" and replace with "$$".
  465.  
  466.             When you execute this macro file, special find, replace, and repeat
  467.             find/replace macros are assigned to keys.  A message is displayed to
  468.             identify the key to which each macro is assigned.
  469.  
  470.             Keys:
  471.                <AltShift F>  FindReplaceEol(TRUE)   // Find only
  472.                <AltShift R>  FindReplaceEol(FALSE)  // Find and Replace
  473.                <AltShift L>  RepeatFindReplaceEol() // RepeatFind
  474.  
  475.             Usage notes:
  476.  
  477.             There are a few limitations to this macro:
  478.  
  479.               1 - Does not support regular expressions.
  480.               2 - Search string cannot be a single '$'.
  481.               3 - When lines are joined by replacing the '$' with nothing,
  482.                   the resulting line must be less than the max line length.
  483.  
  484. InsMatch    Inserts the matching character for a specific groups of chars
  485.  
  486.             Overview:
  487.  
  488.             This macro causes the editor to insert the matching character for a
  489.             specific group of bracketing character pairs, including the
  490.             following:  [], (), {}, <>, '', "".  Execute this macro to toggle
  491.             the "insert matching" mode ON or OFF.  When ON, the matching
  492.             character of a pair is automatically inserted when you type the
  493.             first character.  For example, if you enter the character {, this
  494.             macro inserts the matching character, }.
  495.  
  496.             Keys:     Char  Inserts
  497.                         [     []
  498.                         '     ''
  499.                         "     ""
  500.                         {     {}
  501.                         <     <>
  502.  
  503.             Usage notes:
  504.  
  505.             This macro does not have any key assignments.  To use, simply select
  506.             it from the Potpourri menu.
  507.  
  508.             Each time this macro is executed, the EnterMatching state is
  509.             toggled.  The first time, EnterMatching is enabled.  To disable,
  510.             simple execute the macro again.
  511.  
  512. Justify     Justifies a paragraph based on the right margin
  513.  
  514.             Overview:
  515.  
  516.             This macro work just like the WrapPara() command, but also justifies
  517.             each line to the RightMargin.
  518.  
  519.             Keys:       (none)
  520.  
  521.             Usage notes:
  522.  
  523.             This macro does not have any key assignments.  To use, simply select
  524.             it from the Potpourri menu.
  525.  
  526. LdFList     Loads all files listed in the current file
  527.  
  528.             Overview:
  529.  
  530.             This macro will load all files listed in the current file.
  531.  
  532.             Keys:       (none)
  533.  
  534.             Usage notes:
  535.  
  536.             The list of files to be loaded is assumed to be in the following
  537.             format:
  538.  
  539.             filename1
  540.             filename2
  541.             filename3
  542.             filename4
  543.  
  544.             The list of files is abandoned after the command is completed.
  545.  
  546.  
  547. LongstLn    Locates the longest line in the current file or block
  548.  
  549.             Overview:
  550.  
  551.             This macro locates the longest line in the current file.  When you
  552.             execute this macro, you are positioned on the longest line, and its
  553.             length is displayed on the StatusLine.  If a block is marked in the
  554.             current file, then the search is limited to the block.
  555.  
  556.             Keys:       (none)
  557.  
  558.             Usage notes:
  559.  
  560.             This macro does not have any key assignments.  To use, simply
  561.             select it from the Potpourri menu.
  562.  
  563. Overlay     Flip between two loaded files, showing differences
  564.  
  565.             Overview:
  566.  
  567.             Flips between two files on the screen QUICKLY so file differences
  568.             are apparent.  This macro is intended to show differences in text
  569.             which is somewhat similar. I use the macro to display differences
  570.             between two similar files of source.  This indicates when lines have
  571.             been added or deleted. I then update one or the other files by
  572.             inserting the appropriate # of lines as necessary to only "flicker"
  573.             differences on similar lines
  574.  
  575.             If bookmarks 'A' and 'B' are placed (configurable below) the files
  576.             containing these bookmarks are flipped.
  577.  
  578.             If bookmarks are not specified, Current and Next Files are flipped
  579.  
  580. Para        Macros to go to the end and to the next and previous paragraph
  581.  
  582.             Overview:
  583.  
  584.             These macros will position the cursor on the next or previous
  585.             paragraph, or at the end of the current paragraph.  They assume that
  586.             there is at least one blank line between paragraphs.
  587.  
  588.             Keys:
  589.                       <Ctrl CursorDown>       NextPara()
  590.                       <Ctrl CursorUp>         PrevPara()
  591.                       <Ctrl CenterCursor>     EndPara()
  592.  
  593.             Usage notes:
  594.  
  595.             If you wish to make this macro a permanent part of your
  596.             configuration, then simply add "Para" to the AutoLoad list on the
  597.             Macro menu.
  598.  
  599. Projects    Project management macro for saving and restoring files
  600.  
  601.             Overview:
  602.  
  603.             Project management macro for TSE.  This macro will save currently
  604.             loaded files and several pre-defined editing variables as a named
  605.             project.  The macro may then be run to reload the previously saved
  606.             files for a given project.
  607.  
  608.             Keys:
  609.                   <Ctrl K><M>         ShowMainMenu()
  610.                   <Ctrl K><P>         SaveProjectFiles()
  611.                   <Ctrl K><A>         SaveProjectFilesAndExit()
  612.  
  613.             Usage notes:
  614.  
  615.             Executing Project will prompt the user with a menu allowing PROJECTS
  616.             to be added to the AutoLoad list.  Adding PROJECTS to the AutoLoad
  617.             list will allow projects from the command line or from an initial
  618.             picklist each time the editor is executed.
  619.  
  620.             To make changes to this macro or assign pre-defined functions to
  621.             keys, see the "User Configurable Area" below.
  622.  
  623.             This file contains source for SAVING/RESTORING project information.
  624.             Projects are stored in a PRJ subdirectory located just after the
  625.             directory where the PROJECTS macro is located (eg) C:\TSE\MAC\PRJ.
  626.  
  627.             Now, when you save a project, you will be presented with a message
  628.             box asking you for a project name (!!LAST!! is the default) Note
  629.             that you should select your own name for the project, since !!LAST!!
  630.             will be overwritten each time a project is saved.  That's it --
  631.             project information will be saved, and made available for later
  632.             restoration.  This allows for NEAR SEAMLESS EDITING across sessions.
  633.  
  634.             It is UNNECESSARY to change into the PRJ subdirectory to restart a
  635.             project.  Simply type "e projectname" (with or without the ".PRJ"
  636.             extension), and TSE will automatically open that project for you --
  637.             REGARDLESS OF THE CURRENT DIRECTORY SETTING. (Note also that it is
  638.             NOT necessary to have the "PRJ" subdirectory in your path
  639.             statement).
  640.  
  641.             Although this is convenient, there is ANOTHER WAY.  Every time a
  642.             project is saved, TWO project files are created -- one with the
  643.             project name that you assign when you exit the editor, and the other
  644.             with the name "!!LAST!!.PRJ".  Since an "!" is near the beginning of
  645.             the alphabet, this file should always be the first file in a
  646.             picklist of files.  By starting the editor with just "e <enter>",
  647.             this picklist will be displayed.  Simply press <enter> a second time
  648.             to edit the LAST PROJECT FILES, or move through the picklist to
  649.             choose another project.  If you do not wish to edit a project, just
  650.             press <Escape> to get the familiar "File(s) to edit" box.
  651.  
  652.             Saved information is as follows:
  653.  
  654.             ALL FILENAMES currently being edited.
  655.             ALL STANDARD BOOKMARKS across ALL files.
  656.             ALL AUDIT BOOKMARKS across ALL files.
  657.             ALL KEYSTROKE MACROS (including scrap macro).
  658.             The CURRENT DRIVE AND DIRECTORY.
  659.             The VIDEO MODE (25, 28, 43, or 50 lines).
  660.             The MAIN CLIPBOARD DATA (all marking types).
  661.             Up to 26 NAMED CLIPBOARDS (single characters "A" through "Z" only).
  662.             Any MARKED BLOCK (all marking types).
  663.             The state of INSERT.
  664.             The state of AUTOINDENT.
  665.             The state of WORDWRAP.
  666.             The state of the RIGHT MARGIN.
  667.             The state of the HEX display function.
  668.             The state of the BINARY display function.
  669.             ALL HISTORY information.
  670.  
  671. QuickXit    Quick Exit - prompt for saving or abandoning all changed files
  672.  
  673.             Overview:
  674.  
  675.             An alternative way of exiting the editor.  If no changed files just
  676.             exit.  Otherwise, give the user the choice of either canceling the
  677.             command, quitting the editor without saving the files, or save all
  678.             changed files and then quit the editor.
  679.  
  680.             Keys:     (none)
  681.  
  682.  
  683. RePage      Places page-breaks in current file based on printer settings
  684.  
  685.             Overview:
  686.  
  687.             This macro places formfeed characters (ASCII 12) throughout a file,
  688.             based on the page size.  (The page size is determined by the value
  689.             of the PrintLinesPerPage variable, which can be set from the Print
  690.             Menu, by selecting "Lines Per Page" under "Set Options").  When you
  691.             execute this macro, it pauses on each line where a formfeed should
  692.             go, according to the page size, and places a cursor bar on that
  693.             line.  You can then select that line on which to place the formfeed,
  694.             or move the cursor bar to a previous line in the file to select a
  695.             different line on which to place the formfeed. After you select the
  696.             line for the formfeed, the macro resumes, relative to the location
  697.             of the selected line.
  698.  
  699.             Keys:       (none)
  700.  
  701.             Usage notes:
  702.  
  703.             This macro does not have any key assignments.  To use, simply select
  704.             it from the Potpourri menu.
  705.  
  706. ReplaceF    Reload or replace the current file
  707.  
  708.             Overview:
  709.  
  710.             This macro simply calls the internal ReplaceFile() command to allow
  711.             you to reload the current file (or replace it with another file).
  712.  
  713.             Keys:     (none)
  714.  
  715.  
  716. ShowCurr    Show ascii and hex value of current character on the StatusLine
  717.  
  718.             Overview:
  719.  
  720.             This macro will display the ascii and hex values of the current
  721.             character on the right edge of the status line.
  722.  
  723.             Keys:     (none)
  724.  
  725.  
  726. ShowKey     Displays information about keys available in TSE
  727.  
  728.             Overview:
  729.  
  730.             This macro displays information about the assignable keys on the
  731.             keyboard. When you execute this macro, an information chart is
  732.             displayed on the screen.  You then press a key or key-combination
  733.             (using the <Ctrl>, <Shift>, and <Alt> keys).  If the key is one that
  734.             the editor recognizes as an assignable key, a line is displayed in
  735.             the chart that identifies the following information for that key:
  736.  
  737.               ∙ screen display character (if applicable)
  738.  
  739.               ∙ ASCII code
  740.  
  741.               ∙ scan code
  742.  
  743.               ∙ hexadecimal representation
  744.  
  745.               ∙ decimal representation
  746.  
  747.               ∙ key name (that is, the "name" to use for that key in an editor k
  748.                 assignment)
  749.  
  750.             If the key is not assignable, nothing is displayed when you press
  751.             the key.
  752.  
  753.             Keys:       (none)
  754.  
  755.             Usage notes:
  756.  
  757.             This macro does not have any key assignments.  To use, simply
  758.             select it from the Potpourri menu.
  759.  
  760. State       Save/Restore editor state information (files/windows/etc)
  761.  
  762.             Overview:
  763.  
  764.             This macro allows you to interactively save the editing environment
  765.             for the current session, or restore the previously-saved
  766.             environment.
  767.  
  768.             Keys:       (none)
  769.  
  770.             Usage notes:
  771.  
  772.             The State macro can come in handy when you need to interrupt your
  773.             current editing session to view another set of files.  Without
  774.             exiting from the editor, you can save the environment for the
  775.             current session; load additional files and/or change certain editing
  776.             options; then automatically restore the previous environment so you
  777.             can return to the set of files and options as they were previously.
  778.  
  779.             When you execute this macro, the editor displays a prompt box from
  780.             which you can select "Save State" to save the current editing
  781.             environment, or select "Restore State" to restore the
  782.             previously-saved environment.
  783.  
  784.             Command line format:
  785.  
  786.             state [-g|-l] [-r|-s] [-ffilename]
  787.  
  788.             where:
  789.                 -g  use global state file (default)
  790.                 -l  use local state file
  791.                 -r  restore
  792.                 -s  save
  793.                 -ffilename  alternate file-path (default is tsestate.dat)
  794.                 -q  don't complain if state file not found
  795.  
  796.  
  797.             Things that TSE saves via other means:
  798.  
  799.                 - recent files
  800.                 - history
  801.  
  802.             Things saved via this macro:
  803.                 - bookmarks
  804.                 - windows
  805.                 - files
  806.                 - common-modes
  807.                 - block
  808.  
  809.             Format of the saved information:
  810.  
  811.             [state v1.0]
  812.             [files]
  813.             line row pos xoffset filenames binary_mode display_mode
  814.             [bookmarks]
  815.             bookmark line row pos xoffset filename
  816.             [windows]
  817.             curr_windowid display_boxed show_statusline show_mainmenu show_helpl
  818.             windowid x1 y1 length height line row pos xoffset filename
  819.             [block]
  820.             type begline begcol endline endcol filename
  821.             [modes]
  822.             insert auto wordwrap rightmargin leftmargin tabtype tabwidth backups
  823.  
  824.  
  825.  
  826. Sum         Sums a column of numbers marked as a COLUMN block
  827.  
  828.             Overview:
  829.  
  830.             This macro sums up a column of numbers that have been marked in the
  831.             text as a column block.  The result is optionally inserted in the
  832.             text.  Sum handles decimal and hexadecimal numbers.  For decimal
  833.             numbers, it accepts positive and negative (identified with a
  834.             preceding "-" sign) numbers, as well as decimal-point fractions.
  835.  
  836.             Keys:       (none)
  837.  
  838.             Usage notes:
  839.  
  840.             This macro does not have any key assignments.  To use, simply select
  841.             it from the Potpourri menu.
  842.  
  843.             Sums either base 10 (decimal), base 16 (hexadecimal), or mixed.
  844.  
  845.             For base 10, a fractional part is allowed and may be up to 8 decimal
  846.             places.  Fractions are disallowed for hexadecimal numbers.
  847.  
  848.             For base 16, a preceding '0x' is ignored, as is a trailing 'h'.
  849.  
  850.             For mixed base, a preceding '0x' or a valid hexadecimal letter a-f
  851.             or a trailing 'h' forces base 16 for that entry. Otherwise, base 10
  852.             is assumed.
  853.  
  854.             The fractional part is maintained within (-1,1) to avoid overflow.
  855.  
  856.             Commas within a number are ignored.
  857.  
  858.             Only the final result is placed in the necessary form for display.
  859.  
  860.             To find a number, the cursor scans left to right until a numeric
  861.             sign or valid number is encountered.  Only whitespace is skipped.
  862.             Also, only one sign is allowed.  In other words, --1 is not allowed.
  863.  
  864. TabUtil     Converts tab characters to spaces, or spaces to tab characters
  865.  
  866.             Overview:
  867.  
  868.             This macro converts tab characters in the current file to spaces, or
  869.             converts spaces to tab characters.  When invoked, a menu is
  870.             presented allowing you to select Entab or Detab.
  871.  
  872.             To limit the scope of the conversion to a block, execute the macro
  873.             from within a marked block.  NOTE that it will convert the entire
  874.             lines that the blocks span.
  875.  
  876.             Usage notes:
  877.  
  878.             This macro does not have any key assignments.  To use, simply select
  879.             it from the Potpourri menu.
  880.  
  881.             When entabbing, if a tab character or a single or double quote is
  882.             encountered, the rest of that line is not entabbed.
  883.  
  884. Tree        Generates and displays directory TREE for specified path
  885.  
  886.             Overview:
  887.  
  888.             Generates and displays a directory tree for a given drive and/or
  889.             subdirectory.
  890.  
  891.             Keys:       (none)
  892.  
  893.             Usage notes:
  894.  
  895.             Invoke the TREE macro via the ExecMacro() prompt.  On the
  896.             command-line to TREE you may optionally specify a filespec and
  897.             options:
  898.  
  899.               The 'filespec' is the location to start the tree.  All
  900.               subdirectories under that location will be displayed.
  901.  
  902.  
  903.               Options are
  904.                   -l  Long format
  905.                   -g  Graphical output (default)
  906.                   -t  Show Totals
  907.                   -h  Show Helpline
  908.                   -f  Show Filenames
  909.  
  910.                   If the '-f' option is specified, files meeting the filespec
  911.                   name and extension will be displayed as well.  Note, however,
  912.                   that if a filename is specified, the '-f' option is ON by
  913.                   default.
  914.  
  915.                   For example, "Tree c:\util\*.s" will display all files
  916.                   which match "*.s" within and under the "c:\util" directory.
  917.  
  918.                   If the '-f' option is not specified and no filename is specifi
  919.                   the name and extension are ignored and not displayed.
  920.  
  921.               When the TREE is display, if the '-l' option has been specified,
  922.               <Tab> will toggle between the filename output and fileinfo output.
  923.  
  924. Unload      Quit/Abandon all unchanged files, excluding the current file
  925.  
  926.             Overview:
  927.  
  928.             Use this macro when you have loaded a lot of files (for instance,
  929.             using the multi-file find/replace) and are no longer interested in
  930.             keeping all of them loaded, cluttering things up.
  931.  
  932.             Keys:       (none)
  933.  
  934.  
  935. Where       A "whereis" command for TSE
  936.  
  937.             Overview:
  938.  
  939.             This command will search a drive or multiple drives for the
  940.             specified file(s), and present the user with a list of all such
  941.             found files. From this list, you can either edit or delete the file.
  942.  
  943.             Keys:
  944.                   <CtrlAlt W>         Where()
  945.  
  946.             Usage notes:
  947.  
  948.             Normally, Where searches the drives that have been specified via
  949.             the configuration menu.  However, you can override the default by
  950.             specifying one or more drives along with the filename, as in:
  951.             "cde:*.doc", which would search drives "c", "d", and "e" for all
  952.             "*.doc" files.
  953.  
  954.             Searches may also include a path, for instance:
  955.  
  956.             C:\TSE\*.MAC will find all ".MAC" files in all of the TSE
  957.             subdirectories. (eg) C:.\*.EXE will find all ".EXE" files
  958.             beginning with the current directory.
  959.  
  960. Wipe        Move or Cut a block and fill with spaces
  961.  
  962.             Overview:
  963.  
  964.             This macro file provides two macros:  MoveWipe, which is a variation
  965.             of the MoveBlock command; and CutWipe, which is a variation of the
  966.             Cut (to the System ClipBoard) command.  When you execute Wipe from
  967.             the Potpourri PickList, MoveWipe is assigned to <AltShift M>, and
  968.             CutWipe is assigned to <Shift Grey*>.  These macros behave similarly
  969.             to the commands on which they are based, except that the area of
  970.             text from which the block is moved or cut, is filled with spaces.
  971.             Also, with MoveWipe, if a column block is moved, the editor overlays
  972.             existing text with the contents of the block, rather than inserting
  973.             the contents of the block into its new location.
  974.  
  975.             Keys:
  976.                   <AltShift M>        MoveWipe()
  977.                   <AltShift Grey->    CutWipe()
  978.  
  979.             Usage notes:
  980.  
  981.             If you wish to make this macro a permanent part of your
  982.             configuration, then simply add "Wipe" to the AutoLoad list on the
  983.             Macro menu.
  984.  
  985. Wordcnt     Count the number of words in the block or file
  986.  
  987.             Overview:
  988.  
  989.             Count the number of words in the current file, or, if the cursor is
  990.             in a block, the number of words in the block.  The result is
  991.             displayed.
  992.  
  993.             Words are assumed to be in the set a-z, A-Z, 0-9 and _.
  994.  
  995.